home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d14 / dde_lib.arc / DDEWATCH.TXT < prev    next >
Text File  |  1990-12-25  |  7KB  |  140 lines
  1.                                    DDEWatch 1.0
  2.                              Horizon Technologies Inc.
  3.  
  4.             Overview:
  5.                DDEWatch is a Microsoft Windows program designed to monitor
  6.                Dynamic Data Exchange (DDE) messages.  It is a useful tool
  7.                to aid in the development of DDE based applications.  'C'
  8.                language programmers, Excel macro developers and others can
  9.                use DDEWatch as both a debugging tool and a way to learn
  10.                DDE.
  11.  
  12.                DDEWatch displays each DDE message as it occurs.  The
  13.                information displayed contains the window handles of both
  14.                the sender and receiver, the message type and any additional
  15.                parameters.  These parameters include keyword
  16.                representations of flag fields, command strings, data
  17.                format, and data strings.  DDEWatch displays each new DDE
  18.                message below the previous one.  When the screen is full,
  19.                the next message replaces the first.  A line separates the
  20.                first and last messages captured.
  21.  
  22.                DDEWatch also displays a list of the client-server window
  23.                handles of all active DDE sessions.  DDEWatch maintains this
  24.                list to reflect every new DDE session detected.  When a DDE
  25.                session ends, DDEWatch removes the client-server window
  26.                handles from the list.
  27.  
  28.             Using DDEWatch:
  29.                After invoking DDEWatch, choose Watch from the File menu.
  30.                DDEWatch now displays all DDE message traffic in real time.
  31.                The DDEWatch display is divided vertically into two
  32.                sections.
  33.  
  34.                The left section of the display shows a list of active DDE
  35.                sessions.  The hexadecimal numbers are the client and server
  36.                window handles.  The following figure shows two active
  37.                sessions:  Client "630c" communicating with Server "2f30",
  38.                and Client "5f10" communicating with the same server.
  39.  
  40.     ---------------------------------------------------------------------
  41.     | - |                         DDEWatch                    | \/ | /\ |
  42.     ---------------------------------------------------------------------
  43.     | File                                    |
  44.     ---------------------------------------------------------------------
  45.     | Client Server |630c<-2f30 Data    Advise AckReq Release Fmt=Te|
  46.     |---------------|5f10->2f30 Request    Fmt=Text|Position        |
  47.     |* 630c   2f30  |5f10<-2f30 Data    Response AckReq Release Fmt=|
  48.     |* 5f10   2f30  |5f10->2f30 Ack        App=00|Position            |
  49.     |        |5f10->2f30 Execute    "[l][d]"            |
  50.     |        |5f10<-2f30 Ack        App=00|"[l][d]"            |
  51.     |        |630c->2f30 Ack        App=00|0            |
  52.     ---------------------------------------------------------------------
  53.     |<-| |||                             |->|
  54.     ---------------------------------------------------------------------
  55.  
  56.                The asterisk to the left of the client numbers indicates
  57.                that DDEWatch is displaying messages for that session.  To
  58.                suppress the display for a particular session, position the
  59.                mouse pointer over the client-server pair and click the left
  60.                mouse button.  To resume the display, repeat the procedure.
  61.  
  62.                The right section of the DDEWatch display shows detailed
  63.                information about each DDE message.  The client's window
  64.                handle is always to the left of the server's.  The arrow
  65.                shows the direction of the message.  A left arrow (<-)
  66.                indicates a message from the server to the client.  A right
  67.                arrow (->) indicates a message from the client to the
  68.                server.
  69.  
  70.                The type of message and its parameters are shown immediately
  71.                to the right of the window handles.  The parameters are
  72.                dependant on the type of message and are listed in the
  73.                following table:
  74.  
  75.      Message Type      Parameters
  76.     ------------------------------------------------------------------------
  77.     |Initiate    | Application Name
  78.     |        | (vertical bar)
  79.     |        | Topic Name
  80.     |---------------+-------------------------------------------------------
  81.     |Terminate    | (nothing)
  82.     |---------------+-------------------------------------------------------
  83.     |Advise        | AckReq (iff the fAckReq bit is set)
  84.     |        | DeferUpd (iff the fDeferUpd bit is set)
  85.     |        | Fmt=format name,* or number for a nonstandard format 
  86.     |        | (vertical bar)
  87.     |        | Item Name
  88.     |---------------+-------------------------------------------------------
  89.     |Unadvise    | Item Name
  90.     |---------------+-------------------------------------------------------
  91.     |Ack (Initiate)    | Application Name
  92.     |        | (vertical bar)
  93.     |        | Topic Name
  94.     |---------------+-------------------------------------------------------
  95.     |Ack (Execute)    | Negative (iff fAck is not set)
  96.     |        | (Busy) (iff fBusy is set)
  97.     |        | App=xx (where xx is the hex value of bAppReturnCode)
  98.     |        | (vertical bar)
  99.     |        | "Command string"
  100.     |---------------+-------------------------------------------------------
  101.     |Ack (Other)    | Negative (iff fAck is not set)
  102.     |        | (Busy) (iff fBusy is set)
  103.     |        | App=xx (where xx is the hex value of bAppReturnCode)
  104.     |        | (vertical bar)
  105.     |        | Item Name
  106.     |---------------+-------------------------------------------------------
  107.     |Data        | Response (iff fResponse is set)
  108.     |        | Advise (iff fResponse is not set)
  109.     |        | AckReq (iff fAckReq is set)
  110.     |        | Release (iff fRelease is set)
  111.     |        | Fmt=format name*, or number for a nonstandard format
  112.     |        | "Data" (iff the format of the data is text)
  113.     |        | (vertical bar)
  114.     |        | Item Name
  115.     |---------------+-------------------------------------------------------
  116.     |Request    | Fmt=format name*, or number if a nonstandard format
  117.     |        | (vertical bar)
  118.     |        | Item Name
  119.     |---------------+-------------------------------------------------------
  120.     |Poke        | Release (iff fRelease is set)
  121.     |        | Fmt=format name*, or number for a nonstandard format
  122.     |        | "Data" (iff the format of the data is text)
  123.     |        | (vertical bar)
  124.     |        | Item Name
  125.     |---------------+-------------------------------------------------------
  126.     |Execute    | "Command string"
  127.     ------------------------------------------------------------------------
  128.             * The standard format names that are displayed for the
  129.               DDE messages Advise, Data, Request and Poke are Text,
  130.               BitMap, MetaFile, Sylk, Dif, Tiff and OemText
  131.  
  132.                To pause the displaying of messages for all sessions,
  133.                position the mouse pointer over the right section of the
  134.                DDEWatch display and hold the left mouse button down.  To
  135.                resume, release the button.
  136.  
  137.  
  138. DDEWatch - Copyright (C) 1990 Horizon Technologies Inc.  All rights reserved.
  139.                 (517) 347-0800
  140.